=========================================================
        Sound bridge from OrbiterSound to XRSound
=========================================================
    Copyright (C) 2018-2020 Friedrich Kastner-Masilko
                   face@snoopie.at
---------------------------------------------------------
History:

V2.0    - July, 6th 2020:
        Update to XRSound 2.0

V1.1.1	- Dec, 15th 2019:
	Fixed logging issues by creating log-free version

V1.1	- Sept, 7th 2018:
	First public release
---------------------------------------------------------
Description:

This Orbiter module is a drop-in replacement for the 
popular OrbiterSound (OS) addon by Daniel Polli. It acts
as a bridge from OrbiterSound to XRSound by Douglas
Beachy. With it, addons compiled for OrbiterSound can
play their sounds transparently via XRSound, so only one
sound engine is active at a time.
---------------------------------------------------------
Content:

\Doc
	SoundBridge Readme.txt  - This file
\Modules\Plugin
	OrbiterSound.dll        - Replacement module
	OrbiterSoundWithLog.bak - Alternative log-module
---------------------------------------------------------
License:

Permission is hereby granted, free of charge, to any
person obtaining a copy of this software and associated
documentation files (the ""Software""), to deal in the
Software without restriction, including without
limitation the rights to use, copy, modify, merge,
publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software
is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice
shall be included in all copies or substantial portions
of the Software.

THE SOFTWARE IS PROVIDED ""AS IS"", WITHOUT WARRANTY OF
ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
IN THE SOFTWARE.
---------------------------------------------------------
Installation:

Extract the archive with your Orbiter folder as base
folder and be sure to enable the "use path information"
feature of your favorite extraction tool.

Please be aware, that an already installed OrbiterSound
module should be overwritten in the process. If you want
to keep your old module handy, please make a copy and/or
rename it.

It is not necessary to have OrbiterSound installed.
However, keep in mind that some OS-enabled vessel might
take use of OS stock sounds, so if they are missing those
vessels might not work properly.

Best practice is first installation of OS, check if it
works, then install SoundBridge, followed by installation
of XRSound.
---------------------------------------------------------
Usage:

Activate the plugin in the 'Modules' tab. If you had
OrbiterSound installed before, this should already be the
case.

OrbiterSound should be activated concurrently with 
XRSound for the bridge to work.

SoundBridge is not logging information into Orbiter.log
by default in order to fix performance problems.
If you want to see a log for debugging purposes, rename
OrbiterSound.dll to OrbiterSound.bak and
OrbiterSoundWithLog.bak to OrbiterSound.dll . This will
work the same, but with log entries in Orbiter.log .
---------------------------------------------------------
Known Bugs:

Note that there is currently no 3D support in XRSound, so
vessels using this OrbiterSound feature will sound
differently.